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EXCLUSION OF WARRANTIES 


Ihe information contained in thís manual is subject to 
change without notice. Horizon Computer, Limited shall 
not be liable for technical or editorial errors or 
omissions contained herein; nor for incidental or 
consequential damages resulting from the furnishing, 
performance, or use of this material or product 
described by this material. 


Horizon Computer, Limited makes no warranty, expressed 
or implied, including but not limited to implied uar- 
ranties of merchantability and fitness for a particular 
purposes. All software, hardware, and printed materials 
ага made available solely on ап AS IS basis. 


THE USER ASSUMES SOLE RESPONSIBILITY FOR DETERMINATION 
OF FITNESS OF THIS PRODUCT FOR A PARTICULAR APPLICATION. 


LIMITED THREE MONTH WARRANTY 


Horizon Computer, Limited warrants its Fully built and 
tested RAMDISK to be Free from defects in materials 
and uorkmanship for a period of three months from the 
original date of purchase. This warranty shall extend 
only to the original consumer purchaser. This warranty 
is void if the RAMDISK has been damaged by accident, 
unreasonable use, neglect, improper service, or other 
cause not arising out oF defects in materials or 
workmanship. 


No warranty is made For products other than completed 
RAMDISKs, including printed circuit boards and other 
parts, software programs, and printed matarials. 


Horizon Computer, Limited shall not be liable for loss 
of use of the RAMDISK or other incidental or conse- 
quential damages incurred by the consumer or any other 
user. In any case, Horizon Computer, Limited shall be 
liable only for the cost of the RAnDISK and associated 
materials. 
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ROS modifications by J. Peter Hoddie 
COPYRIGHT 1986, Horizon Computer, Limited 


ALL RIGHIS RESERUED 


TABLE OF CONTENTS 


INTRODUCTION oeeeo0e0e7#eon#+eseeetfes85ee54ae@eeeeneoevs#ss8seeevs#seeeeee4eneasevn1es#ee#ee#66e @ 


COMPATIBILITY @eoeseageseecte0eeneeesneoeern5noeeeneeseseeeseeee#eeesee#eHeeeseee#e#ese 60 0 5 sé 


INSTALLATION INSTRUCTIONS €. € ME 9 06 9080 90 9? 9 9 9 9 0 9 60 c6 @ 


Unpacking the Card ..................,» n n 
Determining CRU Base Address ............... 


Installing the Card €. €«€96 999 99 9906099069 89909 5900 8€ 


Loading the RAMDISK Operating System ....... 


Loading DM-1000 Disk Manager ................ 


CALL SUBPROGRAMS °з с әс сә 09 ө э э 9€ «99 9 8 ев ев 99 9 9 9 99 € оза а ов 


CALL DNCn» Set Drive Number ........... 
CALL NSCn) Set Мах. Sectors ........... 
CALL WO Turn On Write Protect ..... 
CALL WF Turn Off Write Protect .... 
Execute Machine Language .. 
CALL CO Enable DSR RAM ............ 
CALL CF Turn OFF DSR ВАМ........... 


CALL DM Load 0М-1000 from RAnDISK ...... . 


CALL NFCn) Set Number of Floppy Drives 


DELETE ”XBCALL” Download Ext. BASIC Routines .. 
COMMON RAMDISK APPLICATIONS aa ә а в е ө а э э о э ө ае е 


TI Writer / ТК Writer ..... cee rece е ө ө ө ө а а е э ө 
ТІ Multiplan ..................„. «ә» вв 
TI BASIC and TI Extended BASIC ............. 
Editor/Assembler а... а 


IN CASE OF DIFFICULTY ................ ooo ... 


Testing for Repeatability .................› 


RAMDISK as Cause ....... „«» еә о ө ө ө ө ө э ө ә ө ө е ө ө 


Testing the Memory with MEMTEST ............ 
Inability to Access Floppies .............., 
Lock-up on Power-UÜp .................»» ә» ә 


ADVANCED APPLICATIONS oeeeesn5oen5neeoee#e#e5#eoeeteee#8ckees#s8eete#eese е 


Introduction v€ 9 09 90 9.9 9 9 93 5. 23 9 9 8 ө э 96 9 9 9 90 9$ 999 0 9 е @ 


Card Architecture ....... ee 
How to Enable the Memory ...........-... nn 
Loading Your Own Programs ................., 
Experimenting with DSR’S ................» 5 


Writing CALL Subprograms .. 
Disk Contents ............. 


RAMDISK CONSTRUCTION GUIDE у.а... а... 


Introduction 806 0€ 9*9. 9 090 909 09 06 0690 9 0 € 9$ 9$ 00 069 8 65$ ооо е 9 е € 


Eight Construction Steps .................c ә» soon 


Schematic &nd Parts List ......... cece ә а э а э а 


= 


Fr 


(Qquotduao ч OF LUM п 


- 31 - 
INIRODUCT ION 


The HORIZON RAMDISK is a peripheral card For the 
II-SS/4^À Home Computer. The RAMDISK is a battery-backesd, 
solid state device which is intended to emulate all Functions 
OF a TI Floppy disk drive. Ihe primary advantage of the 
RAMDISK is speed; data transfer takes place roughly twenty 
times faster. 


To use the HORIZON RAMDISK you need: 
1) TI-99/4A console and IU or monitor 
2) 39/4 Peripheral Expansion Box 
3) TI Compatible Disk Controller Card 
4) At least one Floppy disk drive 
5) One of the Following Command Modules 
A) TI Extended BASIC 
В) Editor/Assembler 
Сә TI-Writer 


6) 38K Memory Expansion Crecoamended) 


COMPATIBILITY 


Every. attempt has been made to insure that the HORIZON 
RAMDISK will be compatible with TI and third party software. 
The RAMDISK appears to be compatible with TI Writer, 
Editor/Assembler, Multiplan, Logo, Forth, BASIC, Extended 
BASIC and Assembly Language. Most applications concerning 
the above should be compatibles with the RAMDISK. However, 
some software, designed to directly access the Disk 
Controller Card will not recognize the RAMDISK and hence is 
not compatible. Examples include the CorComp Disk Manager 
Program and TI Pascal. Non-standard disk access techniques 
or disk protection schemes could slso cause compatibility 
problems (a.g., TI-ARTIST). 


HORIZON RAMDISK 
INSTALLATION INSTRUCTIONS 
Horizon Computer, Limited 
Оооо воно ооо соо о сова ооо во нове 
CAUTION: Your HORIZON RAMDISK contains 
components which can be damaged by 
STATIC ELECTRICITY. Please Follow the 


instructions balow CAREFULLY! 


**e@eeet ZE @ 
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1) UNPACKING THE CARD 


BEFORE UNPACKING YOUR CARD... you should know it 
contains CMOS КАМ "chips" which are damaged by STATIC 
ELECTRICITY MORE EASILY THAN OTHER LOGIC TYPES. Therefore, 
you should take proper precautions in handling the card as 
described below. THIS IS EXPECIALLY TRUE IN LOU HUMIDITY 
ENVIRONMENTS -- REMEMBER THAT WINTER PRODUCES IDEAL 
CONDITIONS FOR STATIC! 


Most people are aware of the kinds of things that 
produce static charges -- synthstic garasnts, carpeting, 
Plastics Cnot specially treated), etc. When handling the 
card, please use common sense and AVOID CONDITIONS WHICH 
MIGHT PRODUCE STATIC CHARGES. 


Your card has been packaged in a pink static protective 
bag. Save this bag and use it when you transport the card or 
if you have to send it back for service. 


Before unpacking the card, take appropriate precautions 
to prevent static charges. Then make sure you ground 
yourself by touching a metal object -- the INSIDE METAL 
structure of your Peripheral Expansion Box is ideal. When 
endling, try to touch ONLY the edges of the card, and DO NOT 
touch the CMOS memory chips themselves -- they are the larger 
devices which occupy most of the board. 


e) DETERMINING THE CRU BASE ADDRESS 


Your HORIZON RAMDISK has been provided with a DIP CDual 
In-line Package) switch for setting the 
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base CRU address the computer will use to access the RANDISK. 
Look at the top side of the card near the area where the 
edgecard connectors ere located. The DIP switch is labeled 
"suitch" and is locatad between U19 and 020. 


During construction, this DIP switch should have been set so 
that the RAMDISK will respond to CRU address > 1000 -- the top 
switch €1) should be toward the "DN" or "CLOSED" position, 
and all other switches should be toward the "OFF" or "OPEN" 
position. 


Setting the CRU base address to »1000 insures that your 
RAMDISK will be the First device checked on all Input/Output 
operations. IT IS THE BEST WAY TO SET YOUR CARD FOR NEARLY 
ALL COMMON RAMDISK APPLICATIONS Ca.g., TI Writer, 
Editor/Assembler, Multiplan, BASIC, TI FORTH, etc.) 


However, under special circumstances, it may be necessary to 
change the DIP switch setting. If you have another devices in 
your system which is known to be using CRU address >1000 
(such as а MYARC or other brand ramdisk), or if you wish to 
use a second HORIZON card Cwhich, as will become apparent 
later, can be much more than a RANDISK), then you may need to 
change your DIP switch setting. Just remember that ONLY ONE 
switch should be sat in the "ON" position and that, as shown 
below, some positions are already in use -- DO NOT USE ANY 
CRU ADDRESS ALREADY IN USE IN YOUR SYSTEM! 


DIP Switch CRU Address Normal Use 
1 >1000 Not normally used 
2 >1100 Disk Controller Card 
3 >1200 For Modem Card/not used 
4 »1300 RS232 Ports 1 and e 
5 >1400 Unassigned 
6 »1500 RS232 Ports З and Ч 
7 »1500 Unassigned 
8 >1700 Hex Bus/not used 


If you should decida to change your CRU bass address from 
>1000 then DSK1, DSK28, DSK3, and DSKY Cif you have a CorComp 
disk controller) will be unavailable to the RANDISK -- the 
disk controller card at »1100 will always be checked before 
the RAMDISK and the routines on that card will supplant the 
corresponding RAMDISK routines, 


= Ч > 
So, in summary, we recommend that unless you have a strong 
reason to change it, leave DIP switch 1 "ON" so the CRU Базе 
address of the card will be »1000. 
3) INSTALLING THE CARD 

HSSSSEESRSEMKCKSHSSSHECKESKSCSCHSKSCSCHSSCECSSESVUSESSKES 

CAUTION: As with ALL Peripheral Expansion 
Box CPEB) cards, you MUST turn OFF PE-Box 


power and wait a FULL TWO MINUTES before 


SE SE SE SE ZE SE ee а 
).9 9298992928 


installing or removing the RAMDISK card. 
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After removing the сага from the packaging material look for 
the red LED CLight Emitting Diode) nearest one CORNER of the 
board. To orient the card correctly for installation, this 
LED must point toward the FRONT of the Peripheral Expansion 
Box. When the card is properly oriented, all of the IC's and 
other components will be facing the disk drive enclosure. 


Install the card in any available slot -- just make sure that 
none of the components on either side of the card contact the 
"clam-shell" case of an adjacent card. This will avoid a 
short circuit. 


4) LOADING THE RAMDISK OPERATING SYSTEM 


Your System Master diskette contains all of the programs 
required to load the RAMDISK operating system. It is 
recommended that you make & back-up copy and keep the System 
Master diskstte ina safe place. 


Ihe System Master diskette contains a program called UTIL1. 
This is an assembly language loader program for the RAMDISK 
operating system. It requires one of the following modules 
to execute: Extended Basic, Editor/Assembler or TI-Uriter. 
If Extended Basic is used, the files LOAD and YLOAD are also 
required. 


The operating system is contained in two files called 
РАКТЯ_ОЧ and РАВТВ_ОЧ. These files MUST BE PRESENT ON A 
DISKETTE WITH THE NAME ROS so the UTIL1 program can find 
them. CThat is why the System Master diskette is named ROS 
-- ROS is en acronym Рог Ram Operating System. NEVER МАМЕ 
THE КАМОТЗК ROS!) 


The diskette, named ROS containing the above files may be 
Placed in any drive EXCEPT DRIVE 3 Cupon loading the 
operating system the RAMDISK becomes drive 3.) If using 
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Extended Basic place the disk in drive 1. 
to execute the RANDISK operating system loader: 


A) From Extended Basic with the System Master 
disk in Drive 1. 


1) Select Extended Basic from the powerup menu. 
LOAD will be executed automatically. 


с) Sslect 1 from the System Master menu and 
press ENTER. 


or В) From Editor/Assembler, with the System Mastsr 
disk in any drive except drive 3. 


1) Select E/A option 5 СКОМ PROGRAM FILE) 


2) Type: DSKn.UTIL1 press ENTER 


or C) From TI-WRITER, with the System Master disk 
in any drive except drive 3. 


1) Select II-Uriter option З CUTILITY)D 


2) Type: DSKn.UTIL1 press ENTER 


UTILI? may be used For single or multiple RAnDISK 
installations. Upon execution UTIL1 will display the CRU 
addresses from »1000 to »1700, indicate uhether or not a 
Horizon Ramdisk is present st each address, indicate whether 
or not the RAMDISK operating system is loaded, and indicates 
the current setting For Drive Number, Maximum Sector and 
Number of Floppies for each Ramdisk in your PE-box. Thea 
асгош keys allow you to move the cursor around the screen. 
To load the operating system on a Ramdisk type a Y in the 
column for DSR at the appropriate CRU address. IF for some 
reason you wish to disable the operating system type N in the 
Field for DSR. This will have the effect of making that 
RAMDISK invisible to the computer. Tha default values for 
Drive Number, Maximum Sector and Number of Floppies when you 
load the operating system is drive 3, 720 sectors, and e 
floppiss. These values may be altered by simply editing the 
screen. IF you have a single-sided RANDISK Maximum Sectors 
should be set For 360. Exit UTIL1 by pressing FUNCIN 0. 


If you have loaded the operating system For the first time, 
you will need to initialize tha RANDISK before use. To do 
this, you can use most disk managers -- the Disk Manager 11 
Command Module, for instanca, works just fine if your RAMDISK 
is at CRU >1000. However, the RANDISK WILL NOT WORK with 

disk managers designed to access ONLY the disk drive 


controller card Csuch as the CorComp Disk Manager -- the 
CorComp Disk Manager Program will not recognize the HORIZON 
RAMDISK). 


By special agreement with the Ottawa TI 99/4 Users Group, 
your System Master diskette also contains Version 3.3 of Disk 
Manager 1000 CDN-1000) written by Bruce Caron and revised by 
Ralph Romans. Documentation for 01-1000 is files ОМООСРТ1 to 
Ч on the disk named SOURCE-B. The documentation Files may be 
read with TI-Uriter or printed. It is an excellent disk 
manager and, as will be explained more fully later, can be 
loaded directly from BASIC or Extended BASIC with your 
HORIZON RANDISK. 


The first time you load DM-1000, follow this procedure. 


A) From Extended Basic with the System Master 
disk in drives 1... 


1) Select Extended Basic from the powerup manu. 
LOAD will be executed automatically. 


e) Select Z From the System Master menu and 
press ENTER. 


or B) From Editor/Assembler with the System Master disk 
in any drive except drive 3... 


1) Select E/A option 5 CRUN PROGRAM FILE) 


2) Type: DSKn.MGR1 press ENTER 


or С) From TI-Writer with the System Master disk in 
any drive except drive 3... 


1) Select TI-Uriter option 3 CUTILITY). 


2) Type: DSKn.HGR1 press ENTER 


You should now see the 0М-1000 master screen -- if you're at 
all familiar with the CorComp disk manager, you'll find 
0М-1000 very easy to use. Otherwise, PLEASE READ THE 
DOCUMENTATION FILES. 


With DH-1000 loaded, you need to initialize your RAMDISK; 
keeping in mind the values set for drive number and Maximum 
Sectors when you loaded the operating system. IF you have a 
single-sided RAMDISK, change the maximum number of sectors 
with CALL NSC360) from BASIC as described below before 
initializing. 
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After initializing your RAMDISK, use DMN-1000’s File Copy 
utility to copy two files from the System Master disk to the 
RAMDISK These tuo files, MGR1 and MGRe, contain the Dn-1000 
program. Io leave DM-1000, изв ЕСТМ QUIT. 


Once you have completed all of the above steps, you are ready 
to proceed with the remainder of the RAHDISK reference manual. 


= 


CALL SUBPROGRAMS AVAILABLE ON THE HORIZON RAMDISK 


The RANDISK contains nine CALL subprograms which you can 
use directly from TI BASIC or TI Extended BASIC. CAccess 
From a running Extended program is effected using the special 
statement DELETE XBCALL as described below.) Thase 
subprograms can be used either within programs or in Command 
Mode. 


1) CALL DNCn) - CHANGE RAMDISK DRIVE NUMBER 


Whenever the RANDISK operating system is installed, the 
RAMDISK will automatically respond as drive 3; i.e., to DSK3 
access. However, with the CALL DNCn) statement you can 
change the number the RANDISK responds to, and because it is 
battery-backed, it will respond to this number until changed 
with another CALL DNCn) statement. The "n" inside the 
parentheses MUST BE A SINGLE DIGIT FROM 1 TO Б. (Variable 
names аге not allowed.) When the CALL DONCn) statement is 
executed, the RANDISK will respond to any standard disk 
access to that drive number CDSkKn.XY2). 


There are a few restrictions, however. First, no Files 
can be OPEN in either the drive number currently assigned to 
the RANDISK or the drive number to which the RANDISK will be 
changed. For example: 


А) If the RANDISK were set to respond to DSK3; 

В) You had a File OPEN on a diskette in DSK1; and 

Сэ You then tried CALL DNC1) -- which would make 
the RAMDISK respond to any drive 1 access -- you 
would receive an INCORRECT STATEMENT error message 
because of the OPEN File on drive 1. 


However, if you first CLOSE the File in drive 1, then 
CALL DNC1) will work Cassuming no Files are OPEN for drive 3, 
of course). 


Remember, CALL subprograms can be used within a TI BASIC 
program; so if you encounter an INCORRECT STATEMENT error in 
а program which uses CALL DNCn) statements, check to make 
sure all files are CLOSED for both the drive number the 
RAMDISK was and the one it will be. 


Ihe second thing to be aware of involves what happens to 
"гва1” disk drive units normally assigned the number being 
used by the RAMDISK -- they cannot be accessed except by disk 
name. If, For example, you use a CALL DNC2) then all DSKe 
access will reference the RAMNDISK -- if you have a disk drive 
2 attached to your system, it will become “invisible” until 
the RAMDISK drive number is changed. However, you can use 
the disk name option -- DSK.DISKNAME.FILENAME -- to access 
the disk drive which has the same number as the RAMDISK. 
CAnother exception to the above is use of the CorComp Disk 
Manager and other programs that do not recognize the 
RAMDISK.2) 
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д) CALL MSCn) - CHANGE MAXIMUM NUMBER OF SECTORS 


Ihis subprogram sets an upper limit on the number of sectors 
the operating system will recognize as valid. If you try to 
access a sector above this number Cas in initialization of a 
disk) an error condition will occur. Once set, the number 
will remain in effect seven after the system has been 
powered-down because the RAHDISK is battery-backed. 


Your RAMNDISK may vary with respect to the number of "sectors" 
of RAM actually on it. In general, if you have a 
"singls-sided" RAMDISK, the maximum number of sectors is 360 
and if it’s double-sided the maximum is 720. NEVER SET THE 
NUMBER OF SECTORS HIGHER THAN THE ACTUAL AVAILABLE SPACE ОМ 
YOUR RAMDISK. 


The CALL NSCn) statement allows you to inform the operating 
system as to how many sectors are available for use. Again, 
"n" must be a group of DIGITS -- not a variable name. For a 
single-sided RANDISK, you would enter CALL MSC360) and for а 
double-sided one CALL MSC720). 


When the operating system is loaded, it will automatically 
enter a default value of 720. IF you have a double-sided 
RAMDISK, you can initialize it as double sided right away. 
Similarly, if you have a single-sided RAMDISK you may 
initialize it as single sided with no problem, but to avoid 
confusion it is a good idea to set the number of sectors at 
360 before initializing. 


3) CALL WO / WF - TURN DISK WRITE-PROTECT ON AND OFF 


By entering CALL WO Cwrite protect on) from BASIC you have, 
in effect, write protected the entire disk Cthis is much like 
putting a write-protect tab on a diskette). Similarly, by 
entering CALL ШЕ from BASIC, you have removed the disk write 
protection. At the time the operating system is loaded, disk 
urite-protection is "OFF". 


Remember, the RANDISK is battery-backed. IF you write 
protect the ВАМОТЗК today, it will still be writs protected 
when you turn on your system tomorrow. 


4) CALL EXCadr) - EXECUTE MACHINE CODE 


This subprogram allows the user to transfer control of a 
BASIC or Ext. BASIC program to a specified address within 
the computer's CPU memory. The address must be DIGITS -- 
variable names are not allowed. All values are in decimal 
using the same convantions as TI’s CALL LOAD subprogran. 
Since the power-up routine starts at >O00e%, it may be 
executed with the statement: CALL EX(C36), for instance. 


5) CALL CO и CF - TURN DSRam ON AND OFF 


The CALL CO Ccard on) instruction enables the RANDISK 
operating system. You will see the red LED light. At the 
same time it allows you direct access to BK of the operating 
system software Cfrom >4000 to >S7FF) and the first eight 
sectors cf the RAMNDISK (>5800 to OSFFF). This information 
can be eccessed directly from BASIC using the CALL LOAD and 
CALL PEEK subprograms in many modules. But even more 
importantly, in connection with the CALL EX subprogram 
Cdescribed as СУ) above), you can directly link to operating 
system software from TI BASIC. 


Before practical use can be made of this subprogram with 
respect to RANDISK software, you will need the operating 
system source code and other information supplied with the 
RAMNDISK. The CALL CO and CALL CF subprograms ere described 
for those experimenters who will choose to do some work 
Outside the RAMNDISK environment аз described in the 
"Advanced" section of this manual. 


Ihe CALL CF subprogram just shuts the card off, and of course 
the LED goes off. 


6) CALL DM - LOAD Dri-1000 


This subprogram loads the DN-1000 disk manager from the 
RAMDISK if the RAMDISK contains the tuo files MGR1 and HGRe. 
If you have these tuo Files on your RAMDISK, 01-1000 will 
load Crapidly, of course) and if you do not have the two 
Files on your RANDISK, the subprogram should act like а КЕМ 
statement -- nothing will happen. 


DN-1000 turns on drive 1 after it is loaded to look for а 
configuration File. This slows things down by a second or 
so. So if you want really Fast access to 0М-1000, make your 
RAMDISK DSK1 Cusing the CALL DNCn) subprogram described 
above.) | 


73 CALL NFCn2 - SET NUMBER OF FLOPPY DRIVES 


If the base CRU address is set at the normal value of »1000, 
then the CALL NF statement is of no use. 


When the RAMDISK base CRU address is not »1000, a special 
quantity must be specified if 011-1000 is to access the 
RAMDISK. This value is set equal to the number of actual 
Floppy drives attached to the user's system. IF the RAMNDISK 
drive number is set greater than this value, then 01-1000 
will be able to access it. 


If the CRU base is not »1000, then BASIC and other programs 
accessing disk drives can access the RAMDISK only when its 
number is greater than the MAXIMUM number of drives the disk 
drive controller can access СЗ for TI controller and Ч for 
CorComp). However, by proper specification of NF, 01-1000 
can access the RANDISK at any number from e to 6. 
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When the Operating System is loaded, NF has the value of 2. 
In the CALL NFCn) statement, Cn) is a digit betuesn 1 and 5. 
Variable names are not allowed. 


B) DELETE "XBCALL" - DOWNLOAD MACHINE LANGUAGE FOR XB LINKS 


The CALL statements as described above will not executes from 
а running Extended BASIC program. Program mode in Ext. 

BASIC does not scan PE Box cards for CALL routines. The 
DELETE "XBCALL" statement, when exscutead immediately after a 
CALL INIT statement, downloads the machine language for all 
CALLs into the low ВК of the 32K memory expansion unit. 


Ihe routines are then accessed using CALL LINK statements of 
analogous form to the CALL statements above: 


TI BASIC: Extanded BASIC: 


CALL DNCnd --> CALL LINKC”DN”,n) 

CALL М5(п> --> CALL LINKC"MS",n2 

CALL DM --> CALL LINKC”DN”) 
etc. 


The DELETE statement will execute From a running Ext. BASIC 
program: RAMDISK CALL LINK statements can be used in 
auto-load and chained programs. 


The DELETE ”XBCALL” statement MUST immediately follow a 

CALL INIT statement. IF a CALL LOADC”DSKN.PROGNAME”) 
statement is executed in batween the CALL INIT and 

DELETE *XBCALL”, no machine language is downloaded Cand no 
error message is returned). However, other assembly language 
programs can be CALL LOADead after the DELETE if they are 
re-locatable code. 


3) CALL ? - YOUR CALL ROUTINECS) 


The source code for the Operating System, together with the 
information in the "Advanced" section of this manual will 
allow assembly language programmers to add more CALL routines 
to those above. 


Thoss who cars to expsriment with CALL routines and have 
sufficient knowledge of assembly language are invited to do 
so. This can be done sithsr within or outside the RAMDISK 
operating environment. 


COMMON RANDISK APPLICATIONS 


In general, the HORIZON RAHDISK functions just like a 
standard floppy disk drive -- only Faster. Here sre a few 
common application areas in which the RAMDISK saves 
considerable time and makes the TI SS/4A more Fun to use. 


1) TI WRITER 


Anyone who uses TI Writer will appreciate the increase 
in speed and productivity which can be attained using the 
HORIZON RAMDISK. The base CRU address must be set at »1000 
Csee Installation Instructions for an explanation of how to 
set the CRU base address). 


After installing the operating system and initializing 
the RAMDISK, copy the following TI / TK Writer files onto 
your RAMDISK: 

A) EDITAL 


В) EDITAe 
C) FORMAL 
D) FORMAZ 
E) CHARAI Cif using TK Writer) 


Now make your RAMDISK respond to drive 1 by entering the 
BASIC command CALL DNC1). Exit BASIC, insert your TI Writer 
Module, and you’re ready to begin. 


You will notice that the Editor and Formatter now load 
in about one second. There will still be plenty of sectors 
left on the RAMDISK for saving your document while you are 
working on it —— and you should notice a definate increase in 
the speed with which you sre able to save and load your text 
Files using the RANMDISK. 


e) nULTIPLAN 


As with TI Writer, the CRU base address should be »1000 
Csee Installation Instructions for further information). 
Copy the Multiplan System Disk that came with the TI 
Multiplan Module onto the RAMDISK. Make sure the disk name 
is TIMP as is required by the Multiplan system. Маке your 
RAMDISK drive 1 using the CALL DNC1) statement. Now ali 
program accesses by Multiplan will be directed to the RAMDISK 
greatly decreasing the time required. 


Your spreadsheets can, of course, be saved to the 
RAMDISK if you wish. But the real advantage is in the time 
saved in Faster accesses to the OVERLAY and HELP files. 


3) TI BASIC AND EXTENDED BASIC 


The HORIZON RAMDISK is Fully compatible with TI BASIC and 
Extended BASIC. You can load and save programs, open, close, 
read from, and write to all types of Files. The CRU base 
address need not be set at »1000 for use in the BASIC and 
Ext. BASIC environments; however, a higher address Cs.g., 
>1200) would allow use of only П5КЧ, 5, and 8 -- and only 
DSK5 and Б for those with the CorComp Disk Controller. 


With BASIC and Ext. BASIC the speed advantage of the RANDISK 
is not as apparent because although disk access may be 
happening 20 times faster than normal, things like prescan, 
the BASIC and GPL interpreters, etc. require significant 
amounts of time. These factors are, of course, not affected 
by the presence of the RANDISK. 


Ihe RUN "programfile” Extended BASIC statement works fine 
with the RAMDISK. If you write your programs to minimize 
prescan time as described in the Extended BASIC manual, the 
RAMDISK can provide some real speed advantages when chaining 
program segments. Remember that in Extended BASIC programs, 
use of the RAMDISK CALL routines requires the DELETE "XBCALL" 
statement as described in the CALL instructions. 


As with standard disk drives, files can be accessed by disk 
name using the RAMDISK. You can use a statement like: 


200 OPEN #2: "DSK .RANDISK.FILENANE” 


Files can be cataloged from BASIC using the RANDISK using the 
same procedure as with a standard disk drive (sese pg. 37 of — 
the TI Disk Memory System manual.) This allows use of all 
standard menu/auto-load programs. 


Ч) EDITOR/ASSENBLER 


After initializing your RAMDISK, copy the following files 
onto it: 
A) EDIT1I 


В) ASSM1 
C) ASSMe 


Use the CALL DNC1) statsment to make the RAMDISK respond to 
DSK1 access. You can load the Editor or the Assembler in 
about one second! You can also save your source coda on the 
RAMDISK and assamble the object code diractly onto it. This 
results in assembly time about one-third that of a floppy 
drive. The RAMDISK supports all Load and Run and Run Program 
File functions of the Editor/Assembler and Mini Memory 
Command Modules. 
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IN CASE OF DIFFICULTY 


Problems апа "bugs” of various kinds have been found 
with many all computer products, and the HORIZON RANDISK will 
probably be no different in this regard. However, because 
the operating system for the card is in RAN, we can correct 
software problems by sending you a new disk. You can help us 
to improve your RAMDISK by letting us know about the kinds of 
problems you experience in a way that will help us identify 
and correct the problem. 


Whenever you experience & problem in using your RANDISK, 
there are several questions you should try to answer. The 
first is: 


Is the Problem the Repestable 


Using the same piece of software or the same disk, can 
you make the problem happen consistently. CWhile ramdom 
problems are difficult to diagnose, we would still like to 
know about them.) If the problem is repeatable, try making it 
happen after pouering-doun your system and waiting several 
minutes. Also try it immediately after re-loading the 
operating system Cthis will not affect the contents of your 
disk). Any information you can provide to pin down the 
Factors which cause the problem will be of help. 


Is the Problem Specific to the RANDISK 


If you make a sector copy of the RAMDISK contents to a 
Floppy, set the RANDISK number at 6, and try the problem 
situation again using a floppy drive in place of the RANDISK, 
does the problem occur? If so, it may not be related to the 
RAMDISK. In the process of RANDISK software development 
there have been many times us thought there uere problems 
with the RANDISK only to discover the true source of the 
problem was elsewhere in the system. 


One case in point involved intermittent loss of the 
operating system or parts of it. This was traced to a poor 
connection between the speech synthesizer and the flex cable. 
Removing the speech synthesizer solved the problem. 


Is the Problem Hardware Related 


Memory chips can Fail, and so can any of the other 
components of your RAMDISK. In order to facilitate а test of 
your RAMNDISK memory, а TI BASIC program called MENTEST has 
been included on the System Master diskette. МЕМТЕЗТ wipes 


out the ENTIRE contents of the RANDISK including the 
operating system, so make sure you copy important fFilss to a 
floppy diskette before running МЕМТЕЗТ. After running 
MENTEST, the operating system must be reloaded. 


To executs МЕМТЕЗТ: 


A) From Extended Basic with the System Master 
disk in drive 1... 


1) Select Extended Basic from the powerup menu. 
LOAD will executs automatically. 


2) Select З from System Master menu and press ENTER. 


or B) From BASIC with the Editor/Assembler or 
Mini-memory command moduls inserted and 
the System Master disk onlins. 


Type: >OLD DSKn .MENTEST 
> RUN 


МЕМТЕЗТ First asks you to select a CRU address corresponding 
to the DIP switch setting of the RANDISK you wish to test. 
Ths program then asks whether you want to test the 011 chip 
or the entire memory for a single or double sided RANDISK. 

It then proceeds to test the memory by writing and reading a 
series of eighteen special numbers to each of the ВК chips on 
your card to see if they retain the values written. If you 
have a single-sided RANDISK, 13 chips will be tested For each 
test number -- 24 For a double-sided. 


You may Find one or more bad memory chips. Alternatively, 
you may find that for certain numbers several chips appear 
bad. An aven more rigorous test is the Disk Manager II 
comprehensive tast. Test Б of the sesriss has been able to 
locate problems on double-sided cards that no other test 
detects. All such problams have been due to poor soldsr 
connactions on piggy-backed IC’s. If you Find errors, 
contact us rsgarding repair of your card. 


If you do not Find errors, the problem is likely to be in ths 
software which controls the RANDISK. Whsan you have verified 
that the problem is rapesatable, that it is specific to the 
RAHDISK, and that your hardware tests OK, please notify us of 
your problem so that it can be corracted. 


No Accass to Floppy Drives 


If your system appears normal on power-up, but locks up when 
you try to access your Floppy drives, re-load the operating 


system as Follows: Power-down and wait two minutes. Remove 
the card and turn DIP switch 1 to the OFF or OPEN position. 
Turn switch 3 to the ON or CLOSED position to set the CRU 
bass address at 21200. This will allow the disk controller 
card to be accessed before the RANDISK. Re-install the card 
and load the operating system. Power-down again and wait two 
minutes. Then remove the card and re-set the DIP switches as 
desired. 


System Lock-Up on Pouer-Up 


Occasionally Cespecially if you choose to experiment with 
writing your own routines for the card) you may Find that 
when you turn on your computer, you get a blank screen and 
that the computer is "locked-up". If you find that this 
happens only when the RANDISK is plugged into the PE-Box, bad 
data has found its way into the RANDISK operating system 
memory, and the operating system must be re-loaded. (Power 
down and WAIT ТШО MINUTES before removing the RANDISK card.) 


Before the operating system can be re-loaded, the card must 
be made "invisible" to the system. If you have Mini Memory 
or DEBUG on a SUPER-CART module, simply turn on the card 
Cusing the CRU command and entering a 1 for the appropriate 
base address). When you see the LED light, set the contents 
of CPU memory address >ЧООО to О Cit should be >ААО1 
initially). 


Alternatively, you can follow this procedure in BASIC Cwith 
Editor/Assembler or Mini-Mem) or in Extended BASIC Cwith Зек 
memory expansion.) 
1) Power-down the console and PE-Box; 
2) Turn on the console FIRST, then the PE-Box; 
3) Enter TI BASIC Cor Extended BASIC); and 
4) Enter and RUN this program: 
100 CALL INIT 
110 CALL LOADC12266,2,12,16,0,2e9,0,4%,ee4, 
64,0,30,0,4%,224,131,196,2,2e24,131,2e4, 
4,329,0,0,"",-31804,4B,02 
5) This program when RUN should return to the 
Master Title Screen. IF it works, power-up 
the system in the normal fashion -- PE-Box 
FIRST, and you should get a normal screen. 


6) Re-load the RANDISK operating system. 


If this program fails to work the only other alternative is 


to power-doun the system, remove the ВАМОТЗК, and take out 
one of the three NI-CAD battsriss. Allow the card to stand 
For at least 15 to 30 minutes so the memory contents are 
lost. Then rs-insert the battery and place the card back in 
the PE-Box. CRUNNING THE CARD WITHCUT ALL THREE NI-CAD 
BATTERIES IN PLACE MAY CAUSE DAMAGE TO THE MEMORY CHIPS!) 


Your system should now power-up normally. Re-ioad the 
operating system. 


Should you nesd Further assistancs, you may writs to the 
company or call ana of the individuals below Csorry, but our 
extremely lou margins will not allow us to accept collect 
calls.) 

Ron Gries (4195 879-1414 

David Romer (413) 666-6911 
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ADVANCED APPLICATIONS 


The Following portion of the manual is provided for 
those hobbyists, experimenters, and hackers Cand software 
developers) who want to do some programming on their own 
outside the environment of the КАМОТЗК application software. 
Addition of CALL routines to the existing operating system 
can be done by referring to the source code provided. 
However, a detailed discussion of how to do this is beyond 
the scope of this manual. 


While you can use the information provided to write your 
own CALL statemements for BASIC and Extended BASIC Cin 
command mode only) or experiment with power-up, interrupt, or 
device service routines, you will first have to erase the 
program which makes the card a RANDISK -- the ROS. What the 
card does then depends upon what software you write for it. 
CThe ROS can be reloaded at any time es described under 
Installation.) 


INTRODUCTION 


The Ram Disk operates entirely within the address space 
reserved for Device Service Routines CDSR’s), viz. >#000 to 
>SFFF. The card may be thought of as being іп one of two 
states -- ON or OFF. Any time the card is on, the LED will 
be lit on the front of the Peripheral Expansion Box, and if 
the LED is not lit, the card is OFF. 


The card is enabled or disabled Cturned on or off) using 
the Communications Register Unit or CRU. Understanding 
exactly how the CRU works can be very difficult. Luckily, 
using the CRU turns out to be very simple and requires little 
if any knowledge of how it works. 


As an assembly language programer, you may have noticed 
the LDCR instruction, and may have even had occasion to use 
it. The LDCR instruction is all that is required to access 
all memory segments of the HORIZON ВЯМОТЗК card. 


ARCHITECTURE OF THE CARD 

The 6K DSR Section 

Figure 1 depicts the RAMDISK memory map. A БК segment 
»4000 to »57FF, is enabled every time the сага is enabled. 
This 6K block holds most of the ROS. There is only one 
memory block that can be enabled in this address space. 

The eK RACK 

The remaining 2K in the DSR space is from >5800 to 


»SFFF. In the »4000 to >S7FF space, there is only one block 
of memory that can be turned on For read-write operations. 


By contrast in the remaining 2K area, »5800 to >SFFF, any one 
of many blocks may be switched on for raading or writing 
data. Ihe 2X sections that can be turned on and off in this 
address space are called RACKS CRAm traCkS). RACKS ага 
numbered. The first RACK is O and the last ona is Se. 


Ihe RAMNDISK Sector 


Ihe RAMDISK application further divides each physical RACK 
into logical sectors -- there аге eight 255 byte sectors per 
RACK CSee Figure 2). This division of the RACK is puraly 
arbitrary in the sense that it is an artiFact of our 
software. A non-ramdisk application would, no doubt, uss a 
different logical organization For the RACKS. 


Single Sided vs. Double Sided 


IF you have a single sided RANDISK, you have all the blocks 
in Figure 1 which have the heavy black line besids them. 
This includes the first 6K, RACKS О through ЧЧ and RACKS 89 
through Se. Double siding a card also adds RACKS 45 through 
68. 


Notice that even if you have a singlea sided card, you have 
КАМ Рог a few sectors of the end of a double sided 
configuration -- 712 to 713. In addition, there are three 
RACKS which are used as integral parts of the ROS. 


The Last Three RACKS 


RACK ЗО contains portions of the ROS. Although wa startad 
out believing we could fit tha program to operate the RANDISK 
in БК, we needed nearly ВХ. Portions of the code which do 
not require disk sector access have been moved to RACK SO. 


RACK 981 contains all of the CALL subprograms you can access 
from BASIC and Extended BASIC. Ihe only exception is CALL 
DM. There is plenty of room left in this block for more 
CALLs or data. 


RACK 92 contains the character patterns used by 071-1000, 
starting with the cursor, ASCII 30. Following this data is 
the machine languaga that gats downloaded for DELETE 
*"XBCALL”. Finally, RACK 92 contains the program that 
transfers this machina languags into the low ВК section of 
the memory expansion unit. Thera is additional room in this 
RACK for more CALLs or data. 
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HOW TO ENABLE THE 6K AREA AND A RACK 
Loading the CRU Bese Address 


Whenever a CRU access is made, the CRU Базе address must be 
loaded in Workspace Register ie. IF the DIP switch settings 
on your card are standard, the CRU base address of the card 
is >1000 -- you would plece »1000 in Rie. If your card is 

set For CRU Базе address »12800, you would place that value in 
Rie. 


Calculating the RACK Code 


Assuming the desired RACK number is known СО - 82), the CRU 
address of the RACK is found as shown below Figure 2 -- 

e * RACK + 7. In а RANDISK exemple, the stating quantity 
would be the sector number CO - 353 or 713). The RACK 
containing that sector is simply the integer value obtained 
by dividing the sector number by В. 


Enabling the DSR and RACK 


Once the RACK code is calculated (2 * RACK + 7), it is placed 
in the most significant byte of a word, and the LDCR GUORD,8 
instruction is executed. This will enable the 6K DSR section 
and the RACK selected. 


Suppose one wanted to enable RACK Se Cand the БК DSR) in an 
assembly language program: 


BASE DATA »1000 ‚ Ваза CRU address set on DIP switch 
€ 

* First Load CRU Base Address 

= 


START МОУ (@BASE,R1e ;Put base CRU accress in Rie 
$ 


* RACK CRU = 2 * RACK + 7 
e 


LI R1,92 ;Put desired RACK in a register 
SLA R1,1 ; Multiply by 2 
AI R1,7 -Add 7 


е Put Собе in Most Sig Byte of а Word 
SUPB R1 ;susp most and least sig bytes 
* Enable БК DSR and RACK Se 
LDCR R1,8 
Nou >4000 - »57FF is the DSR КАМ 


and »5800 - >SFFF is the 2K in RACK Se 


160 4 


Now the address spaca › Ч000 to >SFFF can be accessed as 
ordinary CPU КАМ -- it can ba used to load and run machine 
language, store and fetch data, etc. When the DSR is 
disabled, and the computar system powered down, however, 
everything written to this area will be retained undsr 
battery back-up. 


Disabling the Card 


Io disable the card, load R12 with the base CRU address 
Cusually >1000) and then simply use a SBZ О instruction. 


Load R12 with CRU Base Address 
= 


LI Rie,>1000 


= 


* Disable the Card 
@ 
SBZ О CPS - an SBO here will turn ON 
the card and RACK O) 


If you have accessed the card via a standard DSRLNK routine, 
that routine will turn of fF the card for you upon return. 
However, if you have turned it on explicitly, then you must 
turn it off via your program as described above. Remember 
that the card must always be turned off from a program 
running in memory space outside > ЧООО to »S5FFF -- if you try 
to have the card turn itself off the computer will be faced 
with a bunch of O’s for machine language instructions and 
quickly run amok. 


LOADING YOUR OWN PROGRAMS 


On your System Master diskatts, you will Find a Few programs 
that may ргоуз useful in experiments with the DSR area. 
These include a program to erase the БК DSR and RACKS 30-32 
Cleaving unaffected the actual contents of the RANDISK), and 
the source and object code for a special loader which will 
allow you to load object files creatsd with Editor/Assembler 
directly into the БК and threa ek blocks. 


CLEARING THE OPERATING SYSTEM 


You may disable the RAMDISK operating system by executing the 
UTIL1 loader program and typing an N in the column that 
indicates the status of tha operating system. Ihe >AAO1 in 
the DSR header is removed making tha RAMNDISK invisible to 
your computer. Any information actually contained in the 
SECTORS of the RAMDISK will bs un-sffscted by this operation 
so that immediats restoration of the operating system via 
UTIL1 would again allow access to all disk information. 
(Naturally, if programs you writs for the DSR modify sector 
data, this will not necessarily be ths case!) 
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The LOADER 


Located on your System Master disk is а source code file 
celled LOADER/S. When assembled and run this program loads 
tagged object Files created with Editor/Assembler. Several 
restrictions are involved, however. First, you MUST use only 
Absolute Origin CAORG) code. You can uss аз many AORG 
statements in your program as you like and can even place 
code outside the >4000 to »5FFF DSR space, but LOADER will 
not handle relative code. 


Secondly, you must not use compressed object files. Ths 
loader only works with uncompressed object Files. Do not 
specify a "C" in the options prompt when assembling your 
program. 


Finally, on a given execution, this LOADER makes available 
the standard БК С> ЧООО to >S7FF) and one of the remaining eK 
blocks. You are asked to select which of the eK blocks you 
want enabled when the loader is run. Each of the eK blocks 
CRACKS 90-92) are decoded from »5800 to »5FFF. IF code is to 
be placed in more than one of the three eK blocks, this must 
be done via separate executions of the LOADER program and 
separately assembled object files. Code destined for a гк 
block must be AORG’d with a value of >5800 to »5FFF Cjust as 
code for the БК arsa must be AORG’d from >4000 to >S7FF.) 


You first write and assemble your DSR program. Save the 
un-compressed object File on diskette CNOT RAMDISK). Then, 
with the LOADER program on-line, select Option 3 (Load and 
Run) from the E/A Main Title Screen and enter the File Name: 
DSKx . LOADER 


You will first be asked to enter the name of the object File 
you want loaded. First key in the disk drive number, then a 
decimal point, and Finally the object fils name used when the 
program was assembled. You can use ЕСТМ arrow keys to move 
the cursor forward and backward. When the name is correct, 
press ENTER. 


Then, if the File is found, you will be asked to select which 
of the three 2K blocks AORG’d code from »5800 to »5FFF Cif 
present in your program) is to be placed. RACKS SO to Se are 
eK blocks 1 to 3, respectively. Press key 1, 2, or 3, 
depending on where you want the code to go. If you have no 
code &O0RG'd over the »5800 area, it doses not matter which cK 
block you sslsct. 


After the File is loaded, the loader provides the highest 
address used in both the GK and 2K block. From this 
information you can insure that you havs not excesded the 
limits of the block and determine just how much space is left 
in that block. If the highese address used for a block is 


>0000, mo coda was loaded into that block. When using the 
LOADER, you паза not load coda into either the БК or eK block 
-- what gets loaded will depend upon your AORG statements. 


After the code is loaded, you will be asked to press ENTER to 
continue. Press ENTER, then ЕСТМ QUIT or ЕСТМ BACK. 


EXPERIMENTING WITH DSRs 


A full discussion of DSR block structurs is beyond the scope 
of this manual. A supplementary manual is planned. However, 
Full information can be found in TI’s manual: TI-SS/*4h 
CONSOLE AND PERIPHERAL EXPANSION SYSTEM TECHNICAL DATA. 

Pages 54 and SS give Assambly Language sxamples of DSR header 
Formats and the accompanying text describes the techniques 
used to enter the DSRs as well as for raturns to calling 
programs. 


One area NOT covered in the TI manual, however, is tha 
uriting of routines which can be placed on the card and 
accessed via CALL statements from TI BASIC or TI Extended 
BASIC. The remainder of this section of the manual will 
describe the techniques involved. 


IHE CALL STATEMENT 


Whenever the BASIC interpreter sexecutss а CALL statamant, it 
searches through all potantial CRU addrassss to see if there 
are any valid DSR cards at those addresses. When it Finds а 
card, it gets the address of the CALL Table. The CALL Table 
contains а list of CALL names Clike SOUND, COLOR, SPRITE, 
etc.) Associated with each name is the address at which that 
routins starts and a pointer to the next пата in that list 
Cif any). 


AFter searching all cards, the computer searches GROHS to 
Find the name. IF at any point in the search the name is 
found, that routine is executed and control is returned to 
the BASIC interpretar. 


In order to writs assembly coda which will ba loaded onto thea 
HORIZON card so as to be executed via BASIC CALL statements, 
use the Following Following set-up program: 


SHESHSSSHLHKSHSCHKKCSKCSSSSSERKHKSCSSHSHSSSHSKESKGHSCHKCKHSCSCSSSSCKHKCSSSSSHSCKHSSeGSS 


= 
* The example program below shows the general techniques used in 
* writing CALL routines. These two ere CALL A and CALL BBB which, 
* respectively, fill the screen with A’s and B's when executed from 
* BASIC or Ext BASIC. 
= 
* To try them, First run the CLEAR program. Then used LOADER to load 
~ the object File CCALLDEMO). CIt doesn’t matter which ek block you 
* select.) Once loaded you can try them out from BASIC. 
$ 
Ф. а ee cere о о о ces coe ee „сш ee oe око ско сою сео сию me око бано cme ско = = з» = чью сю анар ч ca =» шо =» сии ыз со шо пи ae оо эзиз we они» ee we сие we шо мыз а= сть «ко 
= 
* General Header For DSRs 
« 
Ф —————————————————————————————————————————————————À—— ee a ә ә 
= 
AORG >4000 Start of БК area 
BYTE >AA Code for valid DSR 
BYTE >01 Version number = 1 
DATA O not used 
DATA O POWER-UP LINK table address 
DATA O not used 
DATA O DSRLNK - used For OPEN, CLOSE etc 
DATA CTABLE CALL ROUTINE LINK table eddress 
DATA O INTERRUPT ROUTINE LINK 
DATA O not used 
= 
| ee cs es ces an a we es we ee wee ae wes ws we es ee we ола ce ws ees we ч ч ee we м = шы we = ш = we ә» = we шь» = ан» чн» we „нь сн» = аз эн» а» эр we Эл» we бнз сш» we a ам» ыз е» 
w 
* The Link Table for CALL Routines 
= 
CTABLE DATA МЕХТ1 LINK to next entry in table 
DATA FILLA ENTRY point for first routines 
BYTE >01 Name length - 1 char in name 
BYTE ’а’ Name of routine - CALL Я 
NEXT1 DATA O A LINK of O means this is the last entry 
DATA FILLB ENTRY point for second routine 
BYTE >03 Name length - 3 bytes 
TEXT 'BBB' CALL BBB is name of this routine 
DATA O 
= 
En a a es ees as ce ce ee о es we we wee ee we we we we оао es eee we ee we aa 


є Use these three DATA statements for all CALLS 
EL 

MASK DATA >4000 
SAVADR DATA O 
IOKEN DATA О 

= 


Mask for Floating point error code 
Holds return address 


Bowe ee we rr ew ee ee um a a wwe we ew we — — — ae — 
= 


* Note that both routines below stert out by saving the return addres 


* and resetting the token pointer to the end of the BASIC line. 
= 


* START OR FILLA 

= 

FILLA MOU R11,@SAVADR 
MOU @>832C,R1 


ерте 9 5 


INC R1 
MOV R1,@TOKEN 


Save return address 

»B3ec -> addr of BASIC token code pointer 
this points to the byte immediately AFTER 
the CALL token in the BASIC program. By 
advancing this value you may read data 
directly from the remainder of the program 
statemsnt. Ultimately, it must point to ths 
End-of-Line mark “0” in the BASIC program an 
in this case the name only contains 1 char. 


Save in TOKEN for return 


е Now do the routine - Fill the screen with A's 


LI R1,>A100 
CLR RO 
SOC @MASK,RO 
SUPB RO 
MOUB ко, а>всог 
SUPB RO 
HOUB ко,@>всог 
LI  R0,768 
МООР MOUB R1,0»8COO 
DEC RO 
JNE ALCOP 
B — GREIURN 


* START OF FILLB 
e 


FILLB MOU R11,@SAVADR 
MOU @>83eC,R1 
AI R1,3 


MOU R1,@TOKEN 
е 


* Nou do routins 
= 
LI К1,> А200 
CLR RO 
SOC @MASK, RO 
SWPB RO 
MOUB RO, @>8С02 
SWPB RO 
MOVB RO, @>8C0e 
LI КО, 758 
BLOOP  HOUB R1,@>8CCO 
DEC RO 
УМЕ BLOOP 
B GRETURN 


"A" B5*95 offset for basic 

Starting UDP RAM address 

indicate a write 

LSB First 

Move into UDPUA 

Nou MSB 

to VDPWA 

768 ”A”s to write 

Write a byte to UDPUD Cauto incrementing) 
Done? 


Done, use common return routines 


Save return addrsss 

Get token pointer 

This name is 3 chars so must add 3 to 
get to the end of the BASIC line 

Save token pointer 


"B" ББ+96 offset for basic 

Starting VDP RAN address 

indicate a write 

LSB First 

Move into VDPWA 

Now МЗВ 

to VDPWA 

758 ”B”s to write 

Write a byte to UDPUD Cauto incrementing?2 
Dona? 


Done, use common raturn routine 


You can uss the following code in any program. If you 
need to return with an error, B @ ERIN. Otherwise, 
В GRETURN. 


Error Return - use for INCORRECT STATEMENT error 


$ 28 SE SE а 


ERIN LI RO, >0700 
MOVB RO,@>834e Make >07 the current token/char 
JMP RIN 


= 


* Non-error Return 

= 

RETURN 52СВ @ 6342 ,@>6834e Make >00 (End of Line) the current token 
RTN MOU @SAVADR,R11 Restore Return Address 


МОО  GTOKEN,R1 Get Token Pointer 

SUPB R1 LSB First 

MOVB R1,@>8C0e Move to VDP Write Address 
SUPB R1 | 

MOUB К}, @>ВСО2 Nou do MSB 

MOU R1,0»839C This resets token pointer 
INCT R11 

SZCB @МАЗК ,@>8354 Floating point error 

B *R11 


MEMORY MAP OF HORIZON RAMDISK OPERATING SYSTEN 
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VERSION ОЧ 


>4000 - »57C7 
1st ex Block: 
› 5800 - >SEDB 


end ek Block: 


»5BO0 - »5BO1 


3rd 2K Block: 


>5800 - »5BOF 
»5B10 - >SE19 
>SE1A - >SE61 
>5ЕБЕ - >5Е01 


Main DSR 
RACK SO - LINK1 = >BBOO 


Portions of DSR cods that 
do not require access to 
RAMDISK contents. Thess 
are accessed via PICHxy 
labels and return via 
RINX labels. | 


RACK 91 - LINKe = »BDOO 


CALL Subprograms except 
CALL DM which is in PARTD. 


RACK Se - LINK3 = »BFOO 


Pattern definitions for 
SB characters used by 
0м-1000. 


Machine language for the 
Extended BASIC analogs of 
the CALL subprograms. 


Definition table showing 
the names of all the XB 
CALL analogs. 


DELETE *XBCALL” code used 
to download the XB call 
analogs. 


РАКТЯ-Е 


CALL/S 
CHAR/S 


XB/S 


DOUNLD/S 


SUXB/S 


CREATE/S 


LOADER/S 


PARTA_O4% 
РАКТВ_ОЧ 


MGR1 
MGRe 


LOAD 


UTIL 


MENTEST 


DOCUMENT 


ОМООСРТ1 
ОМООСРТЧ 


- РВ - 


— DISK CONTENTS - 


Source code for Five parts of the main DSR. 
Use the COPY directive in E/A to assemble into 
one object file. 


Source for CALL subprograms Cexcept CALL DM). 
Pattern definitions used by CALL Dn. 


Extended BASIC analogs of CALL 
subprograms - low Bk. 


DELETE ”"XBCALL” routine. 
Uploads the ХВ/О code to its plece in the third 
ek block. Program name is SUXB. Executed as 
Follows:  »CALL INIT 

»CALL LOADC"DSK1.XB/0") 

»CALL LOADC”DSK1 .SUXB/0”) 

>CALL LINKC”SUXB”) 
Creates PARTA_xy and PARTB_xy memory image files 
holding whatever is in the 12K of DSR space. 
(»54000-»5FFF plus the three eK blocks). 


Source code for loader for uncompressed tagged 
object code AORG files. 


Memory image files of DSR. Used by UTILI. 


Memory image files for 0М-1000 Ver. 3.3. 


Extended BASIC auto-load program for UTIL1, 
DM-1000 and MEMTEST. Requires YLOAD file. 


Loader for Ramdisk Operating System. 


Test program for Horizon Ramdisk. 
TEST/O File. 


Details DSR subroutines as to Work Space, 
Register usage, symbolic addresses, etc. 


Documentation for DN-1000. 


eK 


eK 


CK 


eK 


CK 


CK 


eK 


eK 
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Figure 1 Figure e 
RAM DISK MEMORY MAP SECTOR STRUCTURE 
of RACK 


> ЧООО 


Holds most of 
DSR - the PCM 
that operates 
the RAM DISK 


> 5800 » 5900 
»58FF »S5gFF 

| 
> SAFE »SBFF 

257FF > 5000 > 5000 
> SCFF >SDFF 

>5E00 >SFOQO 
»5EFF > БЕЕЕ 


IF SEC = Sector Number (О - 719), 


RACK INTCSEC/8) 


CRU Addr RACK с * RACK + 7 


CPU Addr SEC = >5800 + 256 * SEC MOD 8 


RACK ЧЧ 352-359 


RACK 45 360-367 
RACK +6 368-371 


OPTIONAL DAL. SIDE 


Routine to 17] Input SECtor number in R6 
2) Enable RACK 
33 Return CPU addr. of SEC in КБ 


CRU DATA »1000 :CRU Base Addr 
LI R6.3°0 :SECtor 320 
BL CADDR :Do 1) - 3) above 
MOU  *R5,R1 :Get First word 320 


RACK BB 704-711 
RACK 89 712-713 


* 


* Routine to Enable RACK, Point to SECtor 
ы 


Remainder| ADDR MOU R6,R? :Copu to R7 
of DSR SRL 7,3 : INTCSEC/BJ^*RACK 
Program SLA R7,3 : B*RAUK 
5 R7,R6 : SEC MOD 8 (rmder Rb) 
CALL Sub- SLA R65,8 :256 * SEC MOD 8 
RACK S1 programs Al R6,>S800:+Base CPU addr in R12 
Cexcept SWPB R7 :Put in MSB of word 
CALL DM3 MOU  GCRÜU,R198:CRU Base addr in Rie 
LDCR R7,8 :Enable RACK 
Char Pattters RT ВБ has CPU of SEC 
n/Language ни 


For XBASIC CALLS, 
DOWN LOADER for 
X/BASIC CALL 
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HORIZON RAMDISK 
CONSTRUCTION GUIDE 


by 


Ron Gries 


COPYRIGHT 1966, Horizon Computer, Limited 
ALL RIGHTS RESERVED 


ооо ово ооо ооо a сос цо р 


THE CONSUMER ASSUMES FULL RISK AND LIABILITY FOR DIRECT 
OR CONSEQUENTIAL DAMAGES ARRISING FROM ATTEMPTED CON- 
STRUCTION OF THE HORIZON RANDISK. 


EXCLUSION OF WARRANTIES: The HORIZON ВАМОІЅК circuit 
board is provided on an AS IS basis. No warranty of 
any Kind is assumed by Horizon Computer, Limited. The 
user assumes full responsibility For quality of all 
parts associated with construction of the HORIZON RAM- 
DISK. Horizon Computer, Limited does not recommend or 
endorse the quality of parts sold by any third party. 
In any case, Horizon Computer, Limited shall be liable 
only for the cost of the circuit board, associated man- 
Vals, and disk based softwars. 


Fully constructed HORIZON RAMNDISKS are availabls with а 
30 day limited warrenty for an additional cost covering 
parts and labor. Contact Horizon Computer, Limited for 
Currant price and availability. 


ня: 
& 9 9 9 SE $ 5$ $5 9992952599 8897828 


hb A ARA ada АСД 


Prior familiarity with construction of digital circuits is 
assumed. Read all construction suggestions and notas 
provided with the eight figures before proceeding. Thes 
following eight pages show progressive stages in completion 
of the HORIZON RANDISK. If you encounter a problem or have 
а question at any step DO NOI PROCEED UNTIL THE PROBLEM IS 
RESOLVED. If you have any questions contact: 

Ron Gries (4195 874-8838, or David Romer (419) 666-6911. 


Although static can bs a problem with CMOS davicas (1.8. 
the 6264LS-1S’s) we have not seen a single case of IC 
damages under ordinary handling procedures; nor have we seen 
problams do to excessive haat. While you may decide to 
take precautions against axcassive static and heat 
transfer, remember that it is equally important THAT ALL 
SOLDER CONNECTIONS ARE OF GOOD INTEGRITY. 


Use a low wattage Cabout 25 watts) soldering pencil апа 
Fine 60:40 tin/lead solder. DO NOT USE a soldering gun or 
acid cora solder! Make surs that sufficient solder is 
supplied to all connections with good wet-out, but that 
thera ага no solder bridges between connsctions. Upon 
completion of all soldering, remove flux From the solder 
side of the board with a commarcial flux remover. 


When inserting IC’s bend the pins to Fit the socket by 
placing the IC on it's side on a flat surface. Bend the 
pins against the surface by moving the body of the IC. 
Make surs all pins are properly aligned with the socket 
holes and that all pins actually go into the socket holes 
upon insertion. 
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FIGURE 1 


The sockets required ars: 13 е8-р4п, 1 гчЧ-ріп, 3 20-pin, 


5 16-ріп and 1 1Ч-ріп. 


Referring to Figure 1, 
sockets are inserted on 
parts are labeled. The 
end. If so, orient the 
are not notched, orient 
left corner. Note that 
SWITCH positions. 


place all sockets on the board. The 


the side of the board on uhich all 
sockets you usa may be notched on ons 
notches as shown. If your sockets 
them with the pin 1 mark in the upper 
sockets are not used for the JACK and 


Place a piece of cardboard or other stiff material over the 
sockets to hold them in place, and turn the board upside down 
for soldering. When soldering the corner pins of each 
socket, apply a little pressure to the board to insure that 
the socket is all the way in. По not apply excessive amounts 


of solder. 


Upon completion of soldering, carefully inspect your work to 
insure that there are no solder bridges between pads. 


A 16 pin socket may optionally Бе used for the DIP switch, 
labeled “switch” on the PC board. 


; 


—— 


FIGURE e 


Install the .1 uF bypass capacitors as shown in Figure 2. 
Glass capacitors are shoun, but any .1 uF capacitors may be 
used. Make surs the components you use are not diodes -- 
diodes have a blue or black band on one end and the bypass 
capacitors do not. These capacitors have no polarity and may 
be orisnted in either direction. As shown in Figure 2, there 
are 2S bypass capacitors. Of these, only C1 is essential to 
proper operation of the unit. While the remaining bypass 
capacitors and C5 should be included, the board will Function 
properly if some of them are omitted. 


Mount the 10 uF tantalum capacitors Ce, C3, and CY as shown 
in Figure 2. These capacitors are polar and must be oriented 
as shown. The positive C+) 1ва4 of these capacitors will bs 
marked on the capacitor body. Make sure you orient each 
capacitor with the positive lead to the right as shoun in 


Figures 2. 


IN 
| 


LII .-...... 


«Сә e» eC e 
= т ае 
| 
ГУ 
e o Д. ау 1N4001 
С ALe 210914 
: : ed 


t 2 


FIGURE 3 


Refer to Figure 3 For diode placement. Three diode types are 
shown: СЕЗ, CRS, and CR10 are 1N914% silicon diodes; CRM, CRS, 
САБ, and CR7 are 1N34A germanium diodes; and СРВ is a 1№001 
rectifier diode. Although similar in appearance, the 1NS914 
silicon diodes are smaller than the 1МЗЧА germanium diodes. 


Diodes are polar. In the ->! notation the arrow points 
toward the cathode C-2. Silicon and germanium diodes have a 
black or blue band on one end to indicates the cathode (-) 
lead. The rectifier diode will likely be black with a silver 
cathode band. Make sure the components you are working with 
are banded Cglass bypass capacitors look similar but are not 
banded), and make sure you orient each diode with the cathodes 
band in the direction shown in Figure 3. 


Next install the 2 Light Emitting Diodes CLED’s). LED’s have 
polarity, and the cathode C-2 of those you are using will Бе 
indicated by a flat side on the LED body or the shorter of 
the two leads. Orient the LED's as shown in the inset. CRe 
should be installed so that the lens points toward the front 
of the card but does not extend beyond the card edge. 


xo 
“з «р з ш т з р ХВ) 
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SWITCH 


FIGURE Ч 


Mount resistors Re - ЕВ and R10 as shown. Although rasistors 
have no polarity, you may orient them so that the color codes 
can be read from left to right. Resistor values and 
corresponding color codes are as Follows: 


Ко 270 Red Uiolst Brown КБ 2.7K Red Viole Red 

R3 2.7K Red Violet Red R7 2.7K Юва Violet Red 
КЧ 2.7K Red Violet Red RB 2.7K Red Violet Red 
RS 10K Black Brown Orangs R10 2.7K Red Violet Red 


Install the 2N2222 transistor Q1. From the top starting with 
the tab and going counter clockwise the three pins of Q1 ars 
emitter, base, and collector CE В and С). Solder the leads 
зо that the case stands about 1/4" above the surfacs of the 


board. 


Install the S-position DIP switch as shown. Solder the leads 
with all switches in the OPEN or OFF position. Then place 
switch 1 in the ON or CLOSED position as shown. 
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FIGURE 5 


Lightly sand the underside of each battery holder to promote 
adhesion. Bend the solder tabs on each battery holder so 
they are parallel with the surface of the board. Observing 
correct polarity, with batteries in place, use five minute 
epoxy to cement the holders to the board surface. Leave 
space between the holders as shown. When the cement has set, 
use short lengths of wire to connect the center holder with 
the two end holders. 


Solder a 33 ohm resistor, R1 (oranges orange black) to the 
board and the negative end of the left battery holder. 

Solder а 270 ohm resistor, R9 Cred violet brown) to the board 
and the positive end of the right battery holder. If you 
plan to use the RANDISK more than five hours a day, use a 470 
ohm resistor for RS to prevent overcharging. For initial 
charging of the batteries, connect a jumper wire to bypass 
the RS resistor -- connect one end of the jumper to the lead 
of RS that is soldered to the board and the other end of the 
jumper to the positive terminal of the battery holder. 

REHOUE THE JUMPER AFTER В TO 10 HOURS OF OPERATION. 


Solder the 7805 voltage regulator in place making sure that 
the hole in the tab lines up with the hole in the board. 
Install a heat sink on top of the tab with a 6-32 1/4” 
machine screw and nut. 
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FIGURE 6 


If the results at any step are not as described STOP AND 
CORRECT THE PROBLEM BEFORE PROCEEDING. 


13 With no IC’s inserted, place the card in tha Peripheral 
Expansion Box and switch on the power. The CR1 LED should 
light and the CRe LED should not light. 


о) Insert all IC's except the thirteen B5e5HLP-15's. Make 
sure the notch of васһ IC points toward the battery holder 
and that the labels on the IC backs ars oriented as shown in 
Figure 6. Install U11, the 626ł4LP-1S5 nearest the left side 
of the board. TO AVOID MEMORY DAMAGE, NEVER PLACE THE CARD 
IN THE PE-BOX WITHOUT ITS BATTERIES! Run the МЕМТЕЗТ program 
as described in the Horizon Ramdisk Reference Manual 
selecting the U11 test. As the program runs the СЕЗ LED 
should flash on and off. IF the program stops or has errors 
check that the DIP switch setting and the CRU address МЕМТЕЗТ 
is testing match. If the DIP switch setting is correct check 
the germanium diodes. We have found that the germanium 
diodes CRY-CR7 ars often the problem. The diodes can Бе 
replaced with Radio Shack Cat. No. 276-1123. 


3) Insert the 128 remaining 6e6YLP-15’s. Re-run the МЕМТЕЗТ 
program. This time selecting the <S>ingle-sidad option. No 
bad chips should be found. 


Ч) Load the Ram Operating System as described in the Users 
Manual. As Final verification that the card is working 
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FIGURE 7 


Eleven 562641Р-15’3 may be added to increase Ramdisk capacity 
to 720 sectors. Before soldering, test the пеш IC's by 
replacing (3-18 and О1е-016. Use the МЕМТЕЗТ program or the 
Disk Nanager 2 comprehensive test. Remove the IC’s and 
arrange into eleven pairs. 


For one IC in each pair, cut the narrow end of pin 20. 
Looking at an IC from the top with notch up, pin eO is the 
sixth from the bottom on the right side. Bend the remaining 
pins inward so they make Firm contact when placed over the 
bottom IC. Making sure notches are matched, place top IC 
Cpin 20 cut) over the bottom IC. 


Keep the ends of the bottom IC pins Free of solder and scraps 
off Flux before reinsertion. THE INTEGRITY OF EACH SOLDER 
JOINT IS VERY IMPORTANT. After soldering and carefully 
inspecting an IC pair, re-heat sach joint to INSURE GOOD 
WET-OUT OF BOTH PINS. 


Bend the remaining portion of cut pin 20 out slightly and 
sOlder one end of a 10” piece of wire-wrap wire | 

Cea.g., 30-24 AWG) to it. Insert each pair in a socket. Cut 
the wire to the correct length and connect to the appropriate 
JACK hole. Finally, arrange the wires between the IC rows as 


shown. 


ІС --> JACK IC -->JACK ІС --> JACK ІС -->JACK 
ОЗ --> 1 О6 --> Ч uiz --> 7 415 --> 15 
ич --> e U7 --> 5 U13 --> 13 416 --> 16 


US --> 3 UB --> Б ült --> 14 
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